home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / comunic / zcomm.zip / ZCOMMDOC.AD < prev    next >
Text File  |  1993-11-27  |  73KB  |  1,771 lines
  1.  
  2.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  3.       ZCOMM User Manual                                                   91
  4.  
  5.       DIRRX, DIRSX, DIRCX, DIRPX, DIRFX Perform the same function as
  6.             described for the DOS flavor above.  (Since Unix does not use
  7.             colon (:) as a device specifier, Unix flavors do not treat
  8.             colon(s) in pathnames in any special way.)
  9.  
  10.       DPORT overrides the default modem port initially accessed by ZCOMM.
  11.  
  12.             EXAMPLE: DPORT=tty12; export DPORT
  13.  
  14.  
  15.       HZ    Indicates the number of kernel "clock ticks" per second.  This
  16.             calibrates terminal function timeouts, protocol timeouts, and
  17.             the sleep command.  The HZ environment variable must be set if
  18.             the value used by your system is not 100 clock ticks per second.
  19.  
  20.       LOGFILE Specifies the pathname for the log file (default:
  21.             /tmp/yamlog.tmp) created by the -v option when invoking ZCOMM as
  22.             xyam, rz, sz, rb, sb, rx, or sx.
  23.  
  24.             SEE ALSO: v option
  25.  
  26.       MODEM Describes the type of modem used by the mm224 script.  See
  27.             Chapter 8 for details.
  28.  
  29.             EXAMPLE: MODEM=MM224E; export MODEM
  30.  
  31.  
  32.       PATH  must include the directories containing yam and the help
  33.             processor yhp.
  34.  
  35.       PHONES overrides the default pathname used to fetch ZCOMM's telephone
  36.             directory.
  37.  
  38.             EXAMPLE: PHONES=/usr/lib/local/localphone.t; export PHONES
  39.  
  40.  
  41.       SHELL ZCOMM uses this environment variable to select the appropriate
  42.             program for its shell escapes.
  43.  
  44.       TERM  If the TERM environment variable contains xterm, xterms or
  45.             anything else beginning with xterm, ZCOMM assumes it is
  46.             operating as a subprocess to the Xwindows xterm(1) program,
  47.             enabling a term function status line if the X numeric parameter
  48.             allows.
  49.  
  50.             SEE ALSO: X numeric parameter The LINES and COLUMNS environment
  51.             variables preset the # and $ numeric parameters respectively.
  52.             This assumption may be overridden by setting the X numeric
  53.             parameter.
  54.  
  55.             If the TERM environment parameter contains the string 401
  56.  
  57.  
  58.       (C) 1993 Omen Tech Inc                       Chapter 16 Running ZCOMM
  59.  
  60.  
  61.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                   92
  63.  
  64.             indicating emulation of a Tektronix 4010 series storage tube
  65.             terminal, status line updates are inhibited when Tek graphics is
  66.             active.
  67.  
  68.             If the TERM environment parameter begins with "wy" (as in
  69.             "wy60") ZCOMM will use and recognize Wyse escape sequences.  The
  70.             TERM environment variable is also checked for AT386 which
  71.             enables a different decoding of keyboard escape sequences.
  72.  
  73.       UUCPLOCK If UUCPLOCK contains "/usr/spool/locks/LCK.." ZCOMM uses
  74.             "Honey Danber" uucp port arbitration conventions.
  75.  
  76.  
  77.       16.3  Dialing in to Unix
  78.  
  79.       Unix flavors may be used for dial-in applications to transfer files
  80.       and commands with programs logged in to terminal ports.  The commands
  81.       rz, sz, rb, sb, rx, rc, sx, zcommand, and zcommandi perform the same
  82.       functions as the corresponding ZCOMM commands.  They may be given
  83.       directly to the shell or executed from a shell script or Makefile.
  84.  
  85.       EXAMPLE: sz -Yn *.c *.h
  86.  
  87.  
  88.       The Makefile fragment below commands a DOS ZCOMM logged into a serial
  89.       port to clear its dirrx string parameter, change to its root
  90.       directory, and then sends a new version of the executable to the DOS
  91.       machine.
  92.  
  93.       EXAMPLE: cpsz:/tmp/yam.exe
  94.                       @zcommand 'set dirrx ""'
  95.                       @zcommand "c:;cd /"
  96.                       @sz -y /tmp/yam.exe
  97.  
  98.  
  99.       More general command sequences or other protocols such as Kermit may
  100.       be accessed with the xyam command.
  101.  
  102.       EXAMPLE: xyam kermit sb *.c *.h
  103.  
  104.  
  105.       EXAMPLE: xyam z pl256 sz -Yn *.c *.h
  106.  
  107.  
  108.       If a many files are specified with wild cards, the shell may not be
  109.       able to pass them to ZCOMM.  The following error will appear:
  110.       /usr/bin/sz: arg list too long
  111.       ZCOMM users can avoid this problem by letting ZCOMM do the wild card
  112.       expansion internally.
  113.  
  114.       EXAMPLE: sz '*'
  115.  
  116.  
  117.       (C) 1993 Omen Tech Inc                       Chapter 16 Running ZCOMM
  118.  
  119.  
  120.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                   93
  122.  
  123.       16.3.1  Initialized Logins  When a user logs in, the Unix shell
  124.       executes commands in .profile in the user's home directory.  This can
  125.       be used to accept file(s) from callers, send file(s), perform suitable
  126.       processing, and log out the user automatically.
  127.  
  128.       The following .profile disables hangup and interrupt signals, then
  129.       invokes xyam to execute commands in a script.
  130.  
  131.       set -e
  132.       trap "" 1 2 3
  133.       xyam source inbound.t
  134.       exit
  135.  
  136.       The following inbound.t receives a file from a hand held aviation
  137.       recorder.
  138.  
  139.                       echo "Send XMODEM file"
  140.                       ena -d
  141.                       rx -y airlink.tmp
  142.                       if ? echo "File Received"
  143.                       if !? echo "Sorry."
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.       (C) 1993 Omen Tech Inc                     Chapter 16 Commands Outline
  177.  
  178.  
  179.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                   94
  181.  
  182.       17.  OUTLINE OF COMMANDS
  183.  
  184.  
  185.  
  186.       17.1  Setup
  187.  
  188.       port 1 ..........................Select the modem port
  189.       portx hbase,vec .................Select non standard modem
  190.       speed 1200 ......................Set the "baud rate"
  191.       handshake {on|off|cts|dsr|dcd|both|slow}Hardware flow control
  192.  
  193.  
  194.       17.2  Data Call
  195.  
  196.       queue............................Manipulate a dialing queue
  197.       call [-N] system ................[N retries]
  198.       234-5678 ........................Dial a local number
  199.       234-5678/mnp ....................Dial a local number with MNP
  200.       %l-503-621-3746 .................Dial long distance
  201.       learn lfile .....................TurboLearn information to lfile
  202.       xpc C ... .......................Enable and control virtual channels
  203.       with X.PC
  204.       bye .............................Disconnect current call
  205.       off .............................Disconnect and exit
  206.       String parameters: phones, mcommand, mprefix, msuffix, mconnect
  207.  
  208.  
  209.       17.3  Interactive Operation
  210.  
  211.       F2, t [-options] ................Begin terminal conversation
  212.       learn lfile .....................TurboLearn information to lfile
  213.       conf ............................Online conference with edit window
  214.       F8 ..............................Generate a password
  215.       enable -options .................Modify term function characteristics
  216.       history histfile.................Enable command recall history
  217.       set .............................Assigns a string or command to a
  218.       function key
  219.       String parameters: break, bs, esc, etx, xpassword, entstr, lpnono
  220.  
  221.  
  222.       17.4  Message Transfer Commands
  223.  
  224.                            Normal Interactive Transfers
  225.       f [-options] file ...............Send file with the term function
  226.       t [-options] file ...............Terminal conversation with capture to
  227.       file
  228.       kill ............................Erase the contents of the circular
  229.       buffer
  230.       w, ALT-W ........................Write the circular buffer
  231.       close, ALT-C ....................Close the capture file
  232.       Term Function Options ...........(capture/send modifiers)
  233.  
  234.  
  235.       (C) 1993 Omen Tech Inc                     Chapter 17 Commands Outline
  236.  
  237.  
  238.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                   95
  240.  
  241.       String parameters: eolstr, blankfill
  242.                               Special File Transfers
  243.       fput ............................High Speed file dump to modem
  244.       fpute ...........................Send file with Echoplex check
  245.       fget ............................High speed modem to disk data dump
  246.  
  247.  
  248.       17.5  Protocol File Transfer Commands
  249.  
  250.       F3, rb [-options] [dir] [file ...] Receive files with YMODEM or Clink
  251.       rz [-options] [dir] [file ...] ..Receive files with ZMODEM
  252.       kermit rb [-options] ............Receive files with Kermit
  253.       rx [-options] rxfile ............Receive a file with XMODEM
  254.       rt [-options] [dir] [file ...] ..Receive files with Telink/FIDO
  255.       r7 [-options] [dir] [file ...] ..Receive files with MODEM7
  256.       ro [-options] rxfile ............Receive a file with XMODEM
  257.       OverThruster
  258.       rw [-options] rxfile ............Receive a file with WXMODEM
  259.       rc [-options] rxfile ............Receive a file with XMODEM/CRC
  260.       sz [-options] txfile ... ........Send file(s) with ZMODEM
  261.       sb [-options] txfile ... ........Send file(s) with YMODEM or Clink
  262.       sx [-options] txfile ............Send a file with XMODEM or XMODEM/CRC
  263.       st [-options] txfile ... ........Send file(s) with Telink/FIDO
  264.       s7 [-options] txfile ... ........Send file(s) with MODEM7
  265.       zcommand COMMAND ................Remote COMMAND with ZMODEM
  266.       !!COMMAND........................Remote COMMAND with Kermit or ZMODEM
  267.       kermit sb [-options] txfile ... .Send file(s) with Kermit
  268.       Kermit Server Access Commands
  269.       AUTOMATIC File Transfers.........(Compuserve-B, Kermit, ZMODEM)
  270.       String parameters: adlopts
  271.       Options for Protocol File Transfers
  272.       Numeric Parameters for XMODEM/YMODEM/ZMODEM Transfers
  273.       Special Keys for Protocol Transfers
  274.  
  275.       17.6  Macro Commands
  276.  
  277.       call system .....................Execute telephone directory entry
  278.       r [oldcmd] ......................Reenter previous command
  279.       Up, Down ........................Select previous commands for reentry
  280.       source scriptfile ...............Call subroutine
  281.       set .............................Assign a string or command to a
  282.       function key
  283.       keys ............................Display soft key definitions
  284.       reskeys .........................Clear soft key definitions
  285.       SOFT KEYS .......................Transmit strings or execute commands.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.       (C) 1993 Omen Tech Inc                     Chapter 17 Commands Outline
  295.  
  296.  
  297.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                   96
  299.  
  300.       17.7  Display Commands / Terminal Emulation
  301.  
  302.       display displaymodes ............Set CRT parameters, screen emulation
  303.       cl, cls .........................Clear the Screen
  304.       mk...............................Map keys for terminal emulation
  305.       videobios N .....................Set video BIOS mode N (for 132 cols)
  306.  
  307.  
  308.       17.8  Disk/File Access Commands
  309.  
  310.       a: ..............................Change default disk
  311.       ap file1 file2 ..................Append file1 to file2
  312.       apd file1 file2 .................Append file1 to file2, delete file1
  313.       cd directory ....................Change directory
  314.       cdd D:dir .......................Change disk and directory
  315.       dir[rlstx] ......................Sorted directory listings
  316.       !DOS-command ....................DOS Gateway to another program
  317.       browse file .....................Browse a set of files
  318.       crc file ... ....................Display 32 bit file CRC's
  319.       del file ........................Delete files from disk
  320.       dump file ... ...................Side by Side HEX/ASCII file dump
  321.       egrep regular-expression file ... Pattern matching file searching
  322.       egrepq regular-expression file ... String extraction
  323.       find string file ... ............Case insensitive file searching
  324.       findq string file ... ...........String extraction
  325.       list file ... ...................List files on DOS standard output
  326.       page file ... ...................Pauses after each screenful
  327.       read file .......................Fill circular buffer from open file
  328.       seek [-]offset ..................Seek to location in file
  329.       Home, End, PgUp .................Enter review function
  330.       sum file ... ....................Display Unix style file checksum
  331.       typ file ... ....................Type (display) files on screen
  332.       wc file ... .....................File character, word, line count
  333.       <file ...........................Simulate keyboard input from file
  334.       >outfile ........................Redirect utility command output
  335.       >>file ..........................Add utility command output to file
  336.  
  337.  
  338.       17.9  Remote Takeover / Control
  339.  
  340.       host ............................Enter Host Operation
  341.       link ............................Connect to another computer
  342.       message .........................Leave a public message
  343.       private .........................Leave a private message
  344.       remote ..........................Accept remote commands
  345.       unrestrict.......................Allow caller unrestricted access
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.       (C) 1993 Omen Tech Inc                     Chapter 17 Commands Outline
  354.  
  355.  
  356.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                   97
  358.  
  359.       17.10  Support Commands
  360.  
  361.       bdump file ......................Dump interrupt input buffer to file
  362.       display displaymodes ............List or change CRT operation
  363.       enable -options..................Modify term function operation
  364.       exit ............................Exit to DOS
  365.       help ............................Activate help database
  366.       kbdlock on|off ..................Lock/Unlock keyboard
  367.       kbdmon [file] ...................Monitor keystrokes in file
  368.       p ...............................Set/display numeric parameters
  369.       reset............................Reset display and disk system
  370.       set .............................Set string parameters / soft keys
  371.  
  372.  
  373.       17.11  Record Keeping Commands
  374.  
  375.       nolog ...........................Inhibit next log entry
  376.       timestamp .......................Display/write time and other info
  377.       restime .........................Reset elapsed time counter to 0
  378.       String parameters: calllog, txlog, rxlog, plog, rxcnt
  379.  
  380.  
  381.       17.12  Script Commands
  382.  
  383.       abort ...........................Returns to command prompt
  384.       accept ..........................Read keyboard response to string
  385.       variable
  386.       bg...............................Indicate background operation
  387.       createx file ....................Exclusive file creation (for
  388.       semaphores)
  389.       echo ............................Display message
  390.       fg...............................Indicate foreground operation
  391.       kill [-signum] procnum ..........Interprocess communications
  392.       lput string .....................Local screen write
  393.       lputp string ....................Output string to printer
  394.       expand script pathspec ..........Execute script for each file in
  395.       pathspec
  396.       fail ............................Failure return from script
  397.       gosub name[.file] ...............Script subroutine call
  398.       goto ............................Branch to label in same script.
  399.       grab svar .......................Read line from file to string
  400.       variable
  401.       if, else.........................Execute rest of line conditionally
  402.       kbdlock on|off ..................Lock/Unlock keyboard
  403.       ki ..............................Reset capture buffer search area
  404.       on ..............................Conditional execution, tested after
  405.       each command
  406.       pattern .........................Specify string searches in modem data
  407.       purge{k|l} ......................Purge typeahead or modem input buffer
  408.       put[v] ..........................Send string [variable] to modem
  409.       return...........................Return to previous script level
  410.  
  411.  
  412.       (C) 1993 Omen Tech Inc                     Chapter 17 Commands Outline
  413.  
  414.  
  415.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                   98
  417.  
  418.       set[c|s] ........................Set string parameters / soft keys
  419.       setn ............................Set string param to Arithmetic
  420.       expression
  421.       set? ............................Set string param to test value
  422.       sleep ...........................Let the world pass by
  423.       source scriptfile ...............Call scriptfile as a subroutine
  424.       split ...........................Split (parse) a string to tokens
  425.       ss ..............................Regular Expression pattern match
  426.       string parse
  427.       trs .............................Translate characters in a string
  428.       wait ............................Wait for pattern(s) in modem data
  429.       while ...........................Looping control
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.       (C) 1993 Omen Tech Inc                         Chapter 17 Special Keys
  472.  
  473.  
  474.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                   99
  476.  
  477.       18.  SPECIAL KEYS
  478.  
  479.       Ctrl-Break clears typeahead, unlocks the keyboard, and stops the
  480.       function ZCOMM is doing in a reasonably orderly manner.[1] Ctrl-Break
  481.       cancels kbdlock.  Ctrl-Break is not so abrupt as the NUKE key.  The B
  482.       test condition tests whether Ctrl-Break has been struck since the last
  483.       purgek command.
  484.  
  485.       Keyboarding ALT-N will NUKE (abort) the current command and return to
  486.       ZCOMM's command prompt.[2] If one or more scripts are active, the
  487.       current line number (counting from the first line in the script file)
  488.       for each level of script is displayed.* NUKE will terminate any
  489.       script.  NUKE closes any transmit file, but not a receive capture
  490.       file.  (A receive capture file may be closed with the "close"
  491.       command.) NUKE does not disconnect the modem by dropping DTR.[3]
  492.  
  493.       Keyboarding ALT-Z appends the contents of the display screen to a DOS
  494.       file.  The pathname is contained in the picture string parameter.  The
  495.       exact contents of the screen memory are written to the file, with each
  496.       screen character followed by its attribute.  A separate program, unpic
  497.       is used to convert the screen dump to a normal file that may be
  498.       printed or displayed.
  499.  
  500.       SEE ALSO: picture string parameter, unpic program
  501.  
  502.  
  503.       18.1  Special Keys during Protocol Transfers
  504.  
  505.       Certain keys perform special functions when keyboarded during protocol
  506.       file transfers (XMODEM, Kermit, etc.).  Some of these keys are
  507.       inhibited when a non error correcting protocol (YMODEM-g) is active.
  508.  
  509.       F1  Keyboarding F1 causes a protocol timeout and forces a retry.
  510.  
  511.       ALT-A Displays Kermit file transfer status.
  512.  
  513.       ALT-B Cancels the current Kermit or ZMODEM batch transfer.
  514.  
  515.  
  516.  
  517.       __________
  518.  
  519.        1. In the term function, Ctrl-Break sends a break to the remote
  520.           unless it has been redefined with a set command.
  521.  
  522.        2. Use of this term, popularized in the J.F.K. administration, does
  523.           not imply endorsement of preemptive nuclear attacks on innocent
  524.           populations.
  525.  
  526.        3. When in host operation waiting for a call, NUKE drops DTR.
  527.  
  528.  
  529.  
  530.       (C) 1993 Omen Tech Inc                         Chapter 18 Special Keys
  531.  
  532.  
  533.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                  100
  535.  
  536.       ALT-C Cancels the ZMODEM or Kermit session.
  537.  
  538.       ALT-F Skips the current ZMODEM or Kermit file transfer.
  539.  
  540.           SEE ALSO: zmodem w numeric parameter
  541.  
  542.       ALT-Q Keyboarding Alt-Q during a protocol file transfer toggles a flag
  543.           that causes ZCOMM to disconnect when the transfer is completed.
  544.           This is most useful when downloading a long file.  As soon as the
  545.           file is transferred, ZCOMM will execute the string parameter
  546.           quitcmd (if set) and then disconnect the modem.  If keyboarded
  547.           during a Host Operation file transfer, ZCOMM will exit Host
  548.           Operation at the conclusion of the transfer.  The state of the
  549.           quit flag is displayed each time ALT-Q is keyboarded.
  550.  
  551.       ALT-S Keyboarding Alt-S displays status information on the console
  552.           screen only (even if in Host Operation).  The pattern number of
  553.           the last successful search (-1 if no match), the active search
  554.           patterns (if any), and the line numbers of the active scripts (if
  555.           any) are displayed to aid script debugging.
  556.  
  557.       ALT-V Keyboarding ALT-V will toggle the view option affecting the rb,
  558.           rc, rz, sb, sc, sx, and sz commands, and data transfers using the
  559.           Compuserve B protocol.
  560.  
  561.       ASCII Keyboarding a normal ASCII character (in the range of 00 to 7F)
  562.           will send that character to the modem.  This may be used for
  563.           protocol testing, or to terminate a modem's autodial handshake
  564.           without terminating ZCOMM's call retry count.
  565.  
  566.       Ctrl-X All ZMODEM and many YMODEM and XMODEM protocol programs
  567.           recognize a dozen successive Ctrl-X characters as a session abort
  568.           command.  If the remote computer appears to be "stuck" in a YMODEM
  569.           or ZMODEM transfer, keyboard ten Ctrl-X characters to abort the
  570.           protocol transfer.
  571.  
  572.       During a protocol transfer, normal keys are sent to the modem when
  573.       Zcomm is waiting for or receiving a packet.  This may be used to
  574.       reissue a file transfer command to the other computer if it becomes
  575.       apparent the original command was not accepted.
  576.  
  577.       Other uses for this pass thru capability include protocol testing.
  578.  
  579.       18.2  Local Editing Keys
  580.  
  581.       Emacs style character editing reduces the number of keystrokes needed
  582.       to enter and edit commands and strings.  Normally the cursor is at the
  583.       end of the line of text being keyboarded.  Printing characters insert
  584.       themselves at the cursor location.  The <ENTER> key enters/transmits
  585.       the entire line of text.
  586.  
  587.  
  588.  
  589.       (C) 1993 Omen Tech Inc                   Chapter 18 Local Editing Keys
  590.  
  591.  
  592.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                  101
  594.  
  595.       Left, Ctrl-B moves the cursor to the left
  596.  
  597.       Right, Ctrl-F moves the cursor to the right
  598.  
  599.       Ctrl-Left cursor WORD left
  600.  
  601.       Ctrl-Right cursor WORD right
  602.  
  603.       Ctrl-A cursor to beginning of line
  604.  
  605.       Ctrl-E cursor to end of line
  606.  
  607.       Del, Ctrl-D delete character at cursor
  608.  
  609.       Backspace delete character to left of cursor
  610.  
  611.       Ctrl-W delete word to left of cursor
  612.  
  613.       Ctrl-End, Ctrl-K delete to end of line
  614.  
  615.       Ctrl-R refresh (redisplay) the line
  616.  
  617.       Ctrl-X delete entire line
  618.  
  619.       Down, Ctrl-N next history line
  620.  
  621.       Up, Ctrl-P previous history line
  622.  
  623.       Ctrl-U Argument Count (not available in term function)
  624.  
  625.       An initial Ctrl-U sets an argument count of 4.  Successive Ctrl-U
  626.       characters multiply the argument count by 4.  A decimal number may be
  627.       entered after Ctrl-U, and this number becomes the argument count.
  628.  
  629.       EXAMPLE: ^U^U Left moves the cursor 16 left
  630.  
  631.  
  632.       EXAMPLE: ^U5X inserts 5 "X" characters
  633.  
  634.  
  635.       EXAMPLE: ^U5^U?  inserts 20 "?" characters.
  636.  
  637.       Unix/Xenix flavors do not support Emacs style editing in the term
  638.       function.
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.       (C) 1993 Omen Tech Inc                        Chapter 18 Main Commands
  649.  
  650.  
  651.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                  102
  653.  
  654.       19.  MAIN COMMANDS
  655.  
  656.       All commands and arguments must be entered in lower case except where
  657.       stated.
  658.  
  659.       You may shorten some commands by typing just the first portion that is
  660.       shown in caps.  For example, the "break" command may be entered as
  661.       "br".  Whether or not you abbreviate the command, it must be entered
  662.       in lower case.
  663.  
  664.       User defined Soft Keys are executed from the command prompt iff they
  665.       do not conflict with the permanent definitions described below.
  666.  
  667.       Except where stated, multiple commands can be written on one line
  668.       separated by ; (semicolon).  Commands that take a constant number of
  669.       arguments do not need a semicolon to delimit the end of the command.
  670.       If in doubt, use a semicolon to separate multiple commands.[1]
  671.  
  672.       @ The at sign may be used to indicate a telephone number starting with
  673.         the Touch-Tone(TM) A B C D * or # codes or a character escape.  If
  674.         the phone number contains spaces, it must be enclosed in double
  675.         quotes.  The leading @ is not sent to the modem.
  676.  
  677.         EXAMPLE: @#*-123-4567 Dials #*-123-4567.
  678.  
  679.  
  680.       %l-234-567-8901 (%l:letter l) For normal long distance dialing, the
  681.         string parameter l (letter l) defaults to "1" (digit 1).  To use an
  682.         alternative long distance service, set the l string parameter with a
  683.         modem command to dial the local access number, wait for the second
  684.         dial tone, and transmit the account number.
  685.  
  686.         SEE ALSO: "setsavenet" telephone directory entry
  687.  
  688.         A string of alternate phone numbers may be specified with the "+"
  689.         construction shown below.
  690.  
  691.       234-5678 A number given as a command invokes the dial script to
  692.         attempt a connection with the specified number.  Iff the modem is
  693.         currently connected to a remote modem, and the B numeric parameter
  694.         is non zero, ZCOMM pulses Data Terminal Ready, terminating the
  695.         connection.  ZCOMM character escapes may be used within the number
  696.         string to represent special characters.
  697.  
  698.  
  699.  
  700.       __________
  701.  
  702.        1. A space or two after each semicolon makes scripts easier for
  703.           humans to read.
  704.  
  705.  
  706.  
  707.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  708.  
  709.  
  710.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                  103
  712.  
  713.         EXAMPLE: 234-5678
  714.  
  715.  
  716.         When carrier is detected, ZCOMM executes the mconnect string (if
  717.         set).  If there is no next command, ZCOMM returns to the command
  718.         prompt.
  719.  
  720.         One or several alternate phone numbers may be specified by appending
  721.         the previous number with +234-5678 for as many alternate numbers as
  722.         are desired.[2] When a connection is made, undialed alternates are
  723.         forgotten.  Alternate phone numbers need not support the same
  724.         speeds.  A redial count given to the call command repeats the
  725.         sequence of alternate numbers.
  726.  
  727.         EXAMPLE: cis  speed 2400 239-6124/mnp_s+239-6126/mnp_s+232-1032/300
  728.         This script line attempts a MNP (with software flow control) call to
  729.         the first two numbers, then a 300 bps call to the third number if
  730.         neither of the first two connected.
  731.  
  732.  
  733.         Iff no connection is made, script processing at the current level is
  734.         terminated.
  735.  
  736.         A number of modifiers are available depending on the type of modem
  737.         and the choice of dialing script used.  These are described in
  738.         Chapter 8.
  739.  
  740.  
  741.         SEE ALSO: nolog command, calllog string parameter, mcommand string
  742.         parameter
  743.  
  744.       a: Change the default disk to a:.  ZCOMM then prints the free storage
  745.         remaining on the selected disk.  The specified disk must be included
  746.         in the string parameter disks.
  747.  
  748.       abort Aborts any command or script in progress.  Closes all script
  749.         files that may be open.  Abort returns to the command prompt.
  750.  
  751.         SEE ALSO: quit command
  752.  
  753.       accept[[l]1] stringvar prompt (letter l, digit 1) Scripts often need
  754.         to prompt the user for file names and menu choices.
  755.  
  756.         Accept displays Prompt[3] to the user.  ZCOMM then reads keyboard
  757.  
  758.  
  759.       __________
  760.  
  761.        2. When using the mm224 dialing script.
  762.  
  763.        3. Prompt must be enclosed in quotes if it contains spaces.
  764.  
  765.  
  766.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  767.  
  768.  
  769.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                  104
  771.  
  772.         input into the specified string variable.  Backspace and Ctrl-U
  773.         perform editing functions.  Characters are accepted from the user
  774.         until <ENTER> is typed.  If the H numeric parameter is non zero, an
  775.         empty string is returned if <ENTER> is not typed within the time
  776.         limit set by that parameter.  Acceptl translates the user's response
  777.         to lower case.  Acceptl1 returns a 1 character string in lower case
  778.         after the single character is keyboarded.
  779.  
  780.         Prompt is processed for string substitution and character escapes.
  781.         If the result begins with an ESC character, ZCOMM does not
  782.         reposition the cursor before accepting the string.  In writing
  783.         scripts, it may be useful to save the current screen location with
  784.         an escape sequence, then restore it with an escape sequence encoded
  785.         in the prompt string.
  786.  
  787.         EXAMPLE: accept s1 File: Displays the prompt File: and reads the
  788.         keyboarded response to string parameter s1.
  789.  
  790.  
  791.         EXAMPLE: acceptl1 s0 "Enter Menu Choice" Reads a single character
  792.         from the user, translates it to lower case, and assigns it to s0.
  793.  
  794.  
  795.         EXAMPLE: accept s0 "\E[20;60H\E[KFile Name: " Places the cursor at
  796.         line 20 column 60, clears the rest of the CRT line, displays the
  797.         prompt, and accepts input.
  798.  
  799.  
  800.         EXAMPLE: accept s6 " Your \E[1mFirst\E[0m name please " Uses
  801.         boldface video to highlight First as it appears in the prompt.
  802.  
  803.  
  804.         EXAMPLE: accept s2 "File "; rc %s2 Prompts the user for a file name,
  805.         then receives that file with XMODEM/CRC protocol.
  806.  
  807.  
  808.         EXAMPLE: accept xpassword "\E[mMaster Password: \E[8m"; lput "\E[m"
  809.         Uses invisible video (ESC [ 8 m) to allow a password to be entered
  810.         without visible echo.  The ESC [ m sequences reset the display to
  811.         normal (visible).
  812.  
  813.  
  814.         SEE ALSO: obey command, scripts
  815.  
  816.       ap file1 file2* (Append) Appends the contents of file1 to file2.  If
  817.         file2 does not exist, it is created.  Wildcards are not allowed.
  818.         The ap command may close files that have been opened by the create,
  819.         f, open, t or > commands.  File1 and file2 are processed for string
  820.         parameter substitution.
  821.  
  822.  
  823.  
  824.  
  825.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  826.  
  827.  
  828.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                  105
  830.  
  831.       apd file1 file2* (Append-Delete) Appends the contents of file1 to
  832.         file2, then deletes file1.  If file2 does not exist, it is created.
  833.         If an error is detected writing file2, file1 is not deleted.
  834.         Wildcards are not allowed.  The apd command may close files that
  835.         have been opened by the create, f, open, t or > commands.  File1 and
  836.         file2 are processed for string parameter substitution.
  837.  
  838.         EXAMPLE: apd %item Z%item.tmp
  839.  
  840.  
  841.       bdump outfile Dumps the contents of the modem interrupt input buffer
  842.         to outfile.  This command is useful for debugging as outfile will
  843.         contain the last characters received from the remote regardless of
  844.         what ZCOMM commands have been executed.  The most recently received
  845.         data appears at the end of outfile.  This command "tells it as it
  846.         is", writing all 8 bits of each character to outfile.  If few
  847.         characters have been received from the remote, some of outfile will
  848.         consist of nulls or garbage.  The bdump command is often used as a
  849.         post mortem diagnostic dump after a failed script or file transfer.
  850.         This command is not available on OS/2, and X.PC flavors of ZCOMM.
  851.  
  852.       bg Indicates ZCOMM is running in the background with no user at the
  853.         keyboard.
  854.  
  855.         SEE ALSO: fg command, df test condition
  856.  
  857.       BReak Sends a 200 millisecond break signal.
  858.         N.B.: Some modems do not correctly pass the break signal to the
  859.         remote.
  860.  
  861.         SEE ALSO: Ctrl-Break key, break string parameter, zmodem B numeric
  862.         parameter
  863.  
  864.       BROwse pathspec Browse through the files specified in pathspec.  If
  865.         pathspec is empty, all files are presented.  For each matched
  866.         pathname, the filename, date, and length of the file are displayed.
  867.         The status line displays some of the commands which may be applied
  868.         to each file.  Chapter 19.4 describes the browse subcommands, which
  869.         provide extensive capabilities for individually selected files.
  870.  
  871.       bye Terminate the connection in progress by sending a long space and
  872.         then dropping DTR (Data Terminal Ready).[4] After a pause, DTR is
  873.         reasserted to allow the modem to originate or answer another
  874.         call.[5]
  875.  
  876.  
  877.       __________
  878.  
  879.        4. The modem must be configured to use Data Terminal Ready (DTR).
  880.  
  881.        5. Most dialing scripts include an initial bye command to make sure
  882.  
  883.  
  884.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  885.  
  886.  
  887.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                  106
  889.  
  890.         SEE ALSO: o, off commands
  891.  
  892.       call [-N] [name][.directory][,modifier] Prepare ZCOMM for a new task
  893.         and invoke an entry in the Phone Directory.  If directory is
  894.         specified, it is searched instead of the regular Phone Directory.
  895.         An optional modifier (string with a leading comma), may be added; it
  896.         is passed to the script.
  897.  
  898.         The 7, A, a, b, C, c, E, e, g, H, h, i, j, n, o, P, p, q, r, S, s,
  899.         t, u, v, w, X, x, Z, and z term options are reset.  The d term
  900.         option is set.  The e, f, g, k, m, p, q, t, w, Kermit 8, zmodem C,
  901.         e, l, L, p, t, T, w, and W parameters are reset to their default
  902.         values.  The search patterns are erased.  Permanent string
  903.         parameters set with the set _svar command are set to empty.
  904.  
  905.         If the search is successful, the entire directory entry name is
  906.         copied to the remote string parameter.  The complete argument
  907.         entered on the command line is stored in the args string parameter
  908.         visible to the called script.  If the script has a READ ONLY
  909.         attribute, ZCOMM is unrestricted during execution of the script.
  910.         ZCOMM then executes the commands on the rest of the line (if any),
  911.         and on succeeding lines beginning with a space or tab.  If the v
  912.         numeric parameter is greater than zero, each command from the file
  913.         is displayed on the screen before it is executed.
  914.  
  915.         It is not necessary to type the entire name as it appears in the
  916.         telephone directory, as ZCOMM will find the first entry that name is
  917.         a prefix of.  Iff name is empty, execution begins with the first
  918.         line of path.
  919.  
  920.         EXAMPLE: call cis1200
  921.              call cis1
  922.              call cis.C:/newscript
  923.  
  924.  
  925.         EXAMPLE: call genie,upl Invokes the genie telephone directory entry
  926.         with the modifier ,upl available to the called script.
  927.  
  928.         The call command is not limited to making connections.  For example,
  929.         "call host" in the distribution PHODIR.t file conditions a Hayes
  930.         compatible modem to answer incoming calls silently, set parameters,
  931.         and activates ZCOMM's host operation.
  932.  
  933.         Most directory entries include a telephone number to dial.  If ZCOMM
  934.         is used with an autodial modem, the number of retries N (default
  935.  
  936.  
  937.       ______________________________________________________________________
  938.  
  939.           any previous call is disconnected.
  940.  
  941.  
  942.  
  943.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  944.  
  945.  
  946.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                  107
  948.  
  949.         none) may be specified.
  950.  
  951.         EXAMPLE: call -40 cbbs-r Attempts 40 retries before giving up.
  952.  
  953.         The interval between retries is set by the i numeric parameter.
  954.  
  955.         EXAMPLE: pi4 Sets the interval between retries to 4 seconds.
  956.  
  957.         Words To the Wise: Abuse of the retry feature by continually calling
  958.         busy numbers may incur the wrath of the Telephone Company.
  959.         Especially with Message Unit Accounting, Big Brother may be watching
  960.         your telecommunications habits.  Some long distance services (MCI,
  961.         Sprint, AT&T, etc.) charge for unsuccessful calls, especially if the
  962.         phone is allowed to ring (or ring busy) for more than a few seconds.
  963.  
  964.         Consult your telephone company about legal limits to the number and
  965.         frequency of retries.
  966.  
  967.         Since some computer services will disconnect within a short time if
  968.         no login is attempted, you should start communicating as soon as the
  969.         modems are connected.  ZCOMM sounds the bell after making the
  970.         connection if retries have been specified.
  971.  
  972.         The source, gosub and call commands may be nested with up to six
  973.         command/phones file descriptors open at once.[6] A label may be the
  974.         target of a call command provided the trailing colon is included in
  975.         name.
  976.  
  977.       cat pathspec For Unix users, a synonym to the type command (q.v.).
  978.  
  979.       cd [dir] Change to directory dir.  If Restricted, dir is checked for a
  980.         parent directory ("cd  .."), and absolute paths ("cd  /src") not
  981.         prefixed by the home string parameter.  Giving cd without an
  982.         argument changes to the directory stored in the home string
  983.         parameter.[7] ZCOMM then stores the current directory in the pwd
  984.         string parameter and displays it unless the v numeric parameter is
  985.         less than 0.
  986.  
  987.         EXAMPLE: cd  /tmp
  988.  
  989.         N.B.: When operating restricted, the home string parameter must
  990.  
  991.  
  992.       __________
  993.  
  994.        6. Deep nesting may require a decrease in the circular buffer memory
  995.           allocation, see Chapter 16.
  996.  
  997.        7. The home parameter is set to the current directory when ZCOMM is
  998.           invoked, but may be changed with the set command.
  999.  
  1000.  
  1001.  
  1002.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1003.  
  1004.  
  1005.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                  108
  1007.  
  1008.         point to a valid directory in order to enforce the intended
  1009.         directory path restriction.
  1010.  
  1011.         SEE ALSO: cdd and pwd commands, home and pwd string parameters
  1012.  
  1013.       cd  D:dir When a disk drive is specified with the cd command, the
  1014.         current directory on that drive is changed but ZCOMM remains logged
  1015.         in on the current drive and directory.  If Restricted, dir is
  1016.         checked for a disk drive ("cd  b:/foo") not contained in the disks
  1017.         string parameter.
  1018.  
  1019.         EXAMPLE: cd D:/tmp
  1020.  
  1021.  
  1022.       cdd D:dir Change to (log in to) disk D and then to directory dir on
  1023.         the specified disk.  If dir is not specified, the root directory is
  1024.         assumed.  ** This is a shorthand equivalent to a D: command followed
  1025.         by a chdir dir command.
  1026.  
  1027.         SEE ALSO: cd command
  1028.  
  1029.       chat Enter the term function to chat keyboard to keyboard.  Characters
  1030.         typed by either keyboard are echoed to both ends, and RETURNS echo
  1031.         as RETURN/LINEFEED.  In Host Operation, chat exits if the caller
  1032.         types Ctrl-Z.
  1033.  
  1034.         Chat will become hostile if the other end also echoes characters.
  1035.         (Try it sometime on a timesharing system; it's fun.)
  1036.  
  1037.       close Writes the contents of the circular buffer iff a receive file is
  1038.         open, then closes the receive and transmit files.  ZCOMM complains
  1039.         if no files were open.
  1040.  
  1041.         SEE ALSO: nolog command
  1042.  
  1043.       closerx Iff a receive file is open, writes the circular buffer then
  1044.         closes the receive file.
  1045.  
  1046.         SEE ALSO: nolog command
  1047.  
  1048.       closetx Closes the transmit file, if it is open.
  1049.  
  1050.         SEE ALSO: nolog command
  1051.  
  1052.       cl Clears the screen.
  1053.  
  1054.       cls Resets display modes and clears the screen.
  1055.  
  1056.       CONFerence Enters the term function with a 1 line window for composing
  1057.         commands and text.  Chapter 21.5 gives details.
  1058.  
  1059.  
  1060.  
  1061.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1062.  
  1063.  
  1064.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                  109
  1066.  
  1067.       crc pathspec Print the CRC-32 and character count for the specified
  1068.         files.  The crc command verifies the identity of two (or more)
  1069.         copies of a file.  Iff the lengths and CRC-32's of two files are the
  1070.         same, the files are almost certainly identical.  Comparing files
  1071.         with the crc command is faster than transmitting a second copy for
  1072.         character by character comparisons.
  1073.  
  1074.         EXAMPLE: "crc", "crc *.c"
  1075.  
  1076.         HINT: To generate a file containing the CRC's of the files in the
  1077.         current directory:
  1078.  
  1079.              >crc.lst
  1080.              crc *.*
  1081.              close
  1082.  
  1083.         After the files are copied, run the commands above (with a different
  1084.         file name), then compare the two files with DIF.EXE to detect any
  1085.         that have changed.
  1086.  
  1087.         SEE ALSO: sum, wc commands
  1088.         Source for a public domain Unix/DOS version of CRC is available.
  1089.  
  1090.       create [-term_options] outfile If a receive capture file is open as
  1091.         the result of a create or t filename command, write the circular
  1092.         buffer and close it.  Then create outfile for use with the term
  1093.         function with options.  The create command is especially useful when
  1094.         you don't want to enter the term function immediately.
  1095.  
  1096.         EXAMPLE: create -ys /tmp/cbbs.tmp[8]
  1097.  
  1098.  
  1099.         SEE ALSO: > command
  1100.  
  1101.       createx outfile Similar to the create command, but does not open
  1102.         outfile if a file with the same pathname already exists.  The
  1103.         resulting error message may be suppressed by setting the v numeric
  1104.         parameter negative.  Scripts may test for success with the r test
  1105.         condition.  The createx command may be used to manage semaphores to
  1106.         lock resources or work entries used by multiple instances of a
  1107.         program.  The createx command is available on Unix and OS/2 flavors.
  1108.  
  1109.         SEE ALSO: kill command
  1110.  
  1111.  
  1112.       __________
  1113.  
  1114.        8. The y option overwrites any existing file with the same name.  The
  1115.           s term option strips most control characters from the resulting
  1116.           disk file.
  1117.  
  1118.  
  1119.  
  1120.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1121.  
  1122.  
  1123.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                  110
  1125.  
  1126.       del pathspec Delete the specified files.  No message is printed if one
  1127.         or more of the specified files could not be deleted.  No
  1128.         confirmation is requested for mass deletes.
  1129.  
  1130.         WARNING: As with all ZCOMM pathspec specifications, a directory name
  1131.         expands to all files in that directory.
  1132.         N.B.: Do not attempt to delete an open file on DOS, especially the
  1133.         history file.
  1134.  
  1135.         SEE ALSO: browse command
  1136.  
  1137.       demand password Scripts must often verify a caller's identity by
  1138.         asking for a password.  The ZCOMM password command allows a caller
  1139.         three chances to enter a given password.  Failure results in
  1140.         disconnection.
  1141.  
  1142.         Password is processed for character escapes and string
  1143.         substitutions.  All security restrictions on string parameters are
  1144.         enforced.
  1145.  
  1146.         If the result is empty, no password is demanded.  Otherwise the user
  1147.         is prompted to enter a string matching password in the correct case.
  1148.         Keyboard input is not echoed.
  1149.  
  1150.         Three attempts to enter password are allowed.  If the password is
  1151.         not correctly entered, DTR is pulsed to force the modem to
  1152.         disconnect the caller, and the ?  numeric parameter is set negative.
  1153.  
  1154.         EXAMPLE: demand %password Requires the caller to enter a string
  1155.         matching the contents of the password string parameter.
  1156.  
  1157.  
  1158.       dir pathspec Display pathnames matching pathspec alphabetized across
  1159.         the page.  Wildcard filename expansions are alphabetical.
  1160.  
  1161.         EXAMPLE: dir
  1162.  
  1163.  
  1164.         EXAMPLE: dir y*.c *.h
  1165.  
  1166.  
  1167.       dirr pathspec Displays the directory with length and creation date of
  1168.         each file.  dirr displays the number of files matched, number of
  1169.         blocks, number of kb in those files, and estimated transmission time
  1170.         at the current transmission speed assuming the fastest protocol
  1171.         available (ZMODEM or YMODEM-g).  XMODEM and Kermit transfers take
  1172.         longer than the displayed estimates.  Wildcard filename expansions
  1173.         are alphabetical.
  1174.  
  1175.       dird pathspec Long Form directory, sorted by date.
  1176.  
  1177.  
  1178.  
  1179.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1180.  
  1181.  
  1182.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                  111
  1184.  
  1185.       dirt pathspec Long Form directory, reverse sorted by date.
  1186.  
  1187.       dirl pathspec Long Form directory, sorted by file length.
  1188.  
  1189.       dirs pathspec Long Form directory, reverse sorted by file length.
  1190.  
  1191.       dirx pathspec Long Form directory, sorted by file extension.
  1192.  
  1193.       DISable{-term_options} Disable options(s) affecting the term function.
  1194.         Chapter 22 describes options affecting the term function.
  1195.  
  1196.         EXAMPLE: dis -t Disables throttle (t term option).
  1197.  
  1198.  
  1199.       display [[no]dismode] ... Without an argument, prints the display
  1200.         modes.  Display modes preceded by NO are turned off.  With one or
  1201.         more arguments, turn on the specified display mode(s).  If an
  1202.         argument is preceded by no, the specified display mode is turned
  1203.         off.
  1204.  
  1205.         If an emulation is specified, it must be the first argument.
  1206.         display command argument changing the terminal emulation (vt100,
  1207.         dasher, lsi-adm3a, 3101, wyse, dumb) disables nlmode and overstrike.
  1208.  
  1209.         The display modes are:
  1210.  
  1211.         vt100 Emulate VT-100, VT-102, SCO Console, and most VT-220 and
  1212.               Teletype 5425 codes.  VT-52 and Zenith H-19 codes are the
  1213.               default.
  1214.  
  1215.               SEE ALSO: 101.MK,STD.MK, script files
  1216.  
  1217.         lsi-adm3a Emulate Lear Siegler ADM3a and Televideo 9xx control
  1218.               codes.
  1219.  
  1220.         dasher Emulate Data General Dasher terminals.
  1221.  
  1222.         3101  Executes IBM 3101 and TI 940 escape codes.
  1223.  
  1224.         wyse  Emulate Wyse terminals in native mode, allow switching the
  1225.               keyboard to keyscan mode.
  1226.  
  1227.               SEE ALSO: WYS.MK script file
  1228.  
  1229.         dumb  Only null, bs, tab, cr and lf are executed, all others
  1230.               display.  As in real life, dumb takes precedence over vt100,
  1231.               vt52, and lsi-adm3a emulation.
  1232.  
  1233.         inhibit Inhibits the display (nothing prints).
  1234.  
  1235.               SEE ALSO: Q term option
  1236.  
  1237.  
  1238.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1239.  
  1240.  
  1241.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                  112
  1243.  
  1244.         nlmode Received newlines (linefeed) display as return/linefeed.  The
  1245.               Enter key is sent as CR/LF.
  1246.  
  1247.         bell=visual Instead of sounding on the speaker, bell characters
  1248.               cause flashing notes to appear on the screen.
  1249.  
  1250.         overstrike Overstruck characters are displayed in bold face or
  1251.               underline (reverse video on CGA) as appropriate.
  1252.  
  1253.         autowrap The 81st character prints on a new line with possible
  1254.               scrollup.
  1255.  
  1256.         rautowrap Allow a backspace from the lest margin to reverse wrap to
  1257.               the last character position on the previous line.
  1258.  
  1259.         8bit  Decode 8bit control characters and G1 character set.
  1260.  
  1261.         stat=off Disables ZCOMM's status line.
  1262.  
  1263.         warpdrive Provides higher display speed without scrolling flicker,
  1264.               but causes noise (snow/chromablizzard) with CGA display
  1265.               adapters.
  1266.  
  1267.         mapkb Allow escape codes from the remote or a file to active
  1268.               alternate keyboard mapping.  The keyboard mapping is defined
  1269.               with a series of mk commands, such as those contained in the
  1270.               std.mk (standard keyboard) or 101.mk (101 key extended
  1271.               keyboard) files.  Other XXX.mk files may be provided; the
  1272.               first few lines of these files indicate the keyboard
  1273.               configuration they set up.  ZCOMM comes initialized with the
  1274.               std.mk mapping, which requires NumLock to be on.
  1275.  
  1276.               EXAMPLE: source std.mk Defines a VT100 keyboard mapping for
  1277.               standard PC and PC-AT keyboards.
  1278.  
  1279.               The term function keyboard mapping enabled by the mapkb
  1280.               command may override some ZCOMM functions.
  1281.         A display nlmode nobell=visual Turns on nlmode display mode and
  1282.         turns off the visual bell.
  1283.  
  1284.  
  1285.         EXAMPLE: display vt100 Enables VT100/VT102 emulation used by many
  1286.         computer systems.
  1287.  
  1288.  
  1289.         SEE ALSO: tcs command
  1290.  
  1291.       dump pathspec Dump the named files in a side by side hex/ASCII format,
  1292.         similar to the CP/M users' group DUMP program.  The ending character
  1293.         number is also displayed.  Zero length files are not displayed.
  1294.  
  1295.  
  1296.  
  1297.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1298.  
  1299.  
  1300.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                  113
  1302.  
  1303.       echo[c|f] [-n] string Echo a line containing a single argument string
  1304.         in reverse video.  The optional -n suppresses reverse video and
  1305.         linefeeds.  Tabs should not be used with the echo command.  The
  1306.         echoc command also echoes its argument to the capture file (if
  1307.         open), without reverse video.  The echof command echoes its argument
  1308.         to the capture file only.
  1309.  
  1310.         EXAMPLE: echoc "File not Accepted" Outputs a line to the screen and
  1311.         to the capture file.
  1312.  
  1313.  
  1314.         EXAMPLE: echo "Dave, This conversation can serve no further
  1315.         purpose." Displays a line on the screen only.
  1316.  
  1317.  
  1318.         SEE ALSO: lput command, r numeric parameter, character escapes
  1319.  
  1320.       egrep[m] regular-expression pathspec ** Display lines in the specified
  1321.         files matching regular-expression.  Regular Expressions are
  1322.         discussed in Chapter 26.
  1323.  
  1324.         The egrepm command finds a line matching regular-expression in each
  1325.         of the specified files, and then pages through the file beginning
  1326.         with the matched line.  At the end of each screen, ZCOMM accepts the
  1327.         same subcommands used with the findm command.
  1328.  
  1329.         EXAMPLE: egrep "^Subject:" *.* Displays all lines that begin with
  1330.         "Subject:".
  1331.  
  1332.  
  1333.         SEE ALSO: findmore command
  1334.  
  1335.         The egrep implementation does not strip the trailing CR/LF from
  1336.         lines read from the disk.  This affects use of the $ regular
  1337.         expression magic character.  When using the $ magic character, the
  1338.         CR/LF at the end of normal lines must be represented as "..$".
  1339.  
  1340.       egrepq regular-expression pathspec ** Silently searches the specified
  1341.         files for the first line matching regular-expression.  Upon a
  1342.         successful search, the contents of this line are stored in the z0
  1343.         string variable and the ?  numeric parameter is incremented.  The
  1344.         egrepq command is useful for fetching password information from a
  1345.         disk file.
  1346.  
  1347.         SEE ALSO: obey command, findq command
  1348.  
  1349.       else Execute the command(s) on the rest of the line if the last if
  1350.         test performed on the current script level was false.
  1351.         N.B.: While else statements in programming languages are connected
  1352.         to a particular if statement according to syntax, the connection in
  1353.         ZCOMM is to the last if statement executed on the level, regardless
  1354.  
  1355.  
  1356.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1357.  
  1358.  
  1359.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                  114
  1361.  
  1362.         of goto's.
  1363.  
  1364.       ENAble {-term_options} Enable options affecting the term function.
  1365.         Chapter 22 describes options affecting the term function.
  1366.  
  1367.         EXAMPLE: ena -h Enables half-duplex (local echo) Half-duplex option
  1368.         causes the term function to display keyboarded characters.
  1369.  
  1370.  
  1371.       estimate length [speed] Use the specified length and optional
  1372.         specified effective speed when displaying information for the next
  1373.         receive file.  A length of 0 bypasses the length substitution.  Once
  1374.         a speed (in effective bits per second) is given, it is used for all
  1375.         locally displayed transmission time calculations until the next
  1376.         speed or port command.
  1377.  
  1378.         EXAMPLE: estimate z2 Uses the file length stored in string variable
  1379.         z2 in calculating the transmission time estimate for the next
  1380.         received file.
  1381.  
  1382.  
  1383.         EXAMPLE: speed 19200; estimate 0 2400 Use an effective transmission
  1384.         speed of 2400 for transmission time estimates instead of the 19200
  1385.         bps interface speed.
  1386.  
  1387.  
  1388.       exit [code] Exit to the operating system with optional code.
  1389.  
  1390.         SEE ALSO: x, o, off commands
  1391.  
  1392.       EXPand sourcefile pathspec ** For each pathname in pathspec, execute
  1393.         the commands in sourcefile with the string parameter item set to the
  1394.         current pathname.  The commands in sourcefile must not themselves
  1395.         contain wildcards (* or ?) or directory pathnames.  If no files
  1396.         match pathspec, sourcefile is not executed.  If the script executed
  1397.         has a READ ONLY attribute, ZCOMM is unrestricted during execution of
  1398.         the script.
  1399.  
  1400.         EXAMPLE: expand plxupl 001* Executes the script plxupl once for each
  1401.         file matching the wild card specification 001*.
  1402.  
  1403.  
  1404.         EXAMPLE: expand a *.arc where the file a contains:
  1405.              obey "!pkxarc -v %item >> arclist"
  1406.         lists the contents of all .arc files to arclist.
  1407.  
  1408.  
  1409.         Chapter 99 explains the use of this command in more detail.
  1410.  
  1411.       f [-term_options] file The f (think of "file") command initiates
  1412.         transmission of file with the term function.  One or more term
  1413.  
  1414.  
  1415.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1416.  
  1417.  
  1418.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                  115
  1420.  
  1421.         function options (described in Chapter 22) may be enabled with the
  1422.         optional term_options flag.
  1423.  
  1424.         If q (TWX) option is enabled, transmission pauses until the called
  1425.         system's answerback restarts it with an XON, or until g option is
  1426.         set.  Otherwise, any XOFF induced transmission pause is reset.
  1427.  
  1428.         Once the file has been opened with the f command, a pattern match or
  1429.         keyboarding F1 or ALT-X will exit the term function with file
  1430.         incompletely transmitted.  The rest of the file may be transmitted
  1431.         by the t, F2, or wait commands.
  1432.  
  1433.         EXAMPLE: f -px message Uploads message paced by the p term option,
  1434.         which sends a carriage return and pauses at the end of each
  1435.         transmitted line until the remote responds with the prompt character
  1436.         (default line feed).  The x term option makes the term function
  1437.         return to the script after the file has been transmitted.
  1438.  
  1439.  
  1440.         EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p file Is useful for
  1441.         uploading a prepared message to a CompuServe bulletin boards using
  1442.         the "SIG" editor (not FILGE).  The eolstr setting sends a carriage
  1443.         return and period after each line to prevent the CompuServe software
  1444.         from reformatting the message.  Pp10000 Sets the pause timeout to a
  1445.         long time.  Pg58 Sets the prompt character to ":".  f -p file
  1446.         Transmits the file.
  1447.  
  1448.  
  1449.         SEE ALSO: b, g, p, r, n, t, w, x, X term options, eolstr string
  1450.         parameter, t and wait commands
  1451.  
  1452.       fail Terminate the current expand command, otherwise return from the
  1453.         current script level.
  1454.  
  1455.         If called directly by another level of script, that level is
  1456.         terminated.
  1457.  
  1458.         The fail command also causes the term function to exit, to allow a
  1459.         function key to be programmed with a macro that exits the term
  1460.         function.
  1461.  
  1462.         If called implicitly by a number presented for dialing, fail
  1463.         terminates the current dialing attempt.  If no retries are left, the
  1464.         call is abandoned.
  1465.  
  1466.       fg Indicates ZCOMM is running in the foreground with a user at the
  1467.         keyboard.
  1468.  
  1469.         SEE ALSO: bg command, df test condition
  1470.  
  1471.  
  1472.  
  1473.  
  1474.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1475.  
  1476.  
  1477.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                  116
  1479.  
  1480.       fget outfile * Gets 8 bit raw data from the modem to outfile without
  1481.         any protocol.  No data is displayed on the screen.  Keyboarding F1
  1482.         terminates recording; any other keyboarded character is sent to the
  1483.         remote.  Iff the g numeric parameter is set to to some value other
  1484.         than its default of 10 (line feed), the fget command terminates upon
  1485.         reading and storing a character matching the g numeric parameter.
  1486.         The fget command also terminates recording on loss of carrier detect
  1487.         signal.
  1488.  
  1489.         This command can be used when the flow of data from the remote
  1490.         cannot be regulated.  Do not set the I numeric parameter to a large
  1491.         value if flow control is not used.
  1492.  
  1493.         The maximum rate attainable without loss of data is limited by the
  1494.         maximum interrupt latency of the operating system and active device
  1495.         drivers.  The time required to write a 512 character buffer to disk
  1496.         may also limit the maximum average data rate.  Each 512 character
  1497.         block must be written before the modem interrupt input buffer
  1498.         overflows with new data.  If the startup time for a floppy disk is
  1499.         excessive, better results will be obtained writing to a hard disk or
  1500.         ramdisk[9] if a suitable device is available.  Tests with an IBM
  1501.         Personal Computer, DOS 2.1, and a Maynard Electronics hard disk
  1502.         suggest that no characters are lost at 9600 baud.  (Your results
  1503.         will vary depending on your configuration and programming habits.
  1504.         California estimates lower.)
  1505.  
  1506.         EXAMPLE: fget rawdata
  1507.  
  1508.  
  1509.       find string pathspec Find and display lines containing matches to
  1510.         string in the specified files.  Lower case characters in string
  1511.         match either case; upper case characters in string match upper case
  1512.         characters only.  If string contains spaces, tabs, or semicolon, it
  1513.         must be enclosed by double quote characters.  ZCOMM C style escapes
  1514.         may be used to represent control characters and string parameters to
  1515.         be searched for.  Assuming normal DOS files (with CR/LF at the end
  1516.         of each line), a \n at the beginning of string forces a match to the
  1517.         beginning of a line.  A \r at the end of string (\n if the file(s)
  1518.         have no returns in them) forces a match at the end of the line.
  1519.  
  1520.         The file name being searched and its length are displayed in the
  1521.         status line.  For each line that contains a match to string, the
  1522.         file name (if more than one file), line number, and the text of the
  1523.         line are displayed.
  1524.  
  1525.  
  1526.  
  1527.       __________
  1528.  
  1529.        9. See comments on Extended Memory ramdisks in Chapter 34.
  1530.  
  1531.  
  1532.  
  1533.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1534.  
  1535.  
  1536.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                  117
  1538.  
  1539.         EXAMPLE: find count *.c Finds all occurrences of count or COUNT in
  1540.         the named files.
  1541.  
  1542.  
  1543.         SEE ALSO: egrep command
  1544.  
  1545.       FINDMore string pathspec Findmore finds a line matching string in each
  1546.         of the specified files, and then pages through the file beginning
  1547.         with the matched line.  Otherwise, it is similar to the find
  1548.         command.  When the screen is filled up, the prompt More?  appears.
  1549.         Typing space displays another screenfull.  Typing n skips to the
  1550.         next instance of string that has not yet been displayed.  Typing ^Q
  1551.         or ^S displays one more character from the file.  Typing ^X skips to
  1552.         the next file.
  1553.  
  1554.         SEE ALSO: egrepm, page commands
  1555.  
  1556.       findq string pathspec Silently searches the specified files for the
  1557.         first line matching string.  The processing of string is identical
  1558.         to the find command described above.  Upon a successful search, the
  1559.         contents of this line are stored in the z0 string variable and the ?
  1560.         numeric parameter is incremented.  The findq command is useful for
  1561.         fetching password information from a disk file.
  1562.  
  1563.         SEE ALSO: egrepq command
  1564.  
  1565.       finish Terminates Kermit server operation on the remote system.
  1566.  
  1567.       fput file * Puts data from file to the remote at maximum speed without
  1568.         any protocol.  Flow control as determined by the handshake command
  1569.         and the S numeric parameter is respected.  After each 256
  1570.         characters, the number of characters transmitted is displayed, and
  1571.         the keyboard is polled.  Hitting any key will abort the transfer.
  1572.         This command is useful for testing RS232 peripherals at high rates.
  1573.  
  1574.         EXAMPLE: fput datafile
  1575.  
  1576.  
  1577.       fpute file * Echoplex transmit a file to the remote, waiting for the
  1578.         correct echo to each character transmitted (for Throttle/10
  1579.         seconds).  The echoed character is sent to the CRT screen.  If fpute
  1580.         receives a space as an echo to a tab, fpute waits for the spaces to
  1581.         stop echoing for at least 100 milliseconds before resuming
  1582.         transmission.  Transfer speed thus suffers when tabs are present in
  1583.         the transmitted file unless the remote can be set to echo tabs as
  1584.         tab characters instead of expanding them to spaces.  Throughput is
  1585.         less than 1/3 of normal because of the echo delay.
  1586.  
  1587.         Fpute counts each time the correct character is not echoed as an
  1588.         error.
  1589.  
  1590.  
  1591.  
  1592.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1593.  
  1594.  
  1595.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                  118
  1597.  
  1598.         With n option, fpute transmits only a linefeed at the end of each
  1599.         line.  With r option, fpute transmits only a carriage return at the
  1600.         end of each line.  Most applications would use one of these options.
  1601.  
  1602.         CPMEOF (Ctrl-Z) terminates the file transmission unless b option is
  1603.         set.
  1604.  
  1605.         Because fpute waits for the correct echo to each character sent,
  1606.         fpute should be used for transmitting characters to programs that
  1607.         echo exactly.
  1608.  
  1609.         Often it is easy to write a simple receive routine to synchronize
  1610.         with the sender by echoing each character received.  On some
  1611.         microcomputer systems, the device "TTY:" does just that.  Fpute is
  1612.         especially useful for "spoon feeding" files to the serial inputs of
  1613.         microcomputers and minicomputers.
  1614.  
  1615.         SEE ALSO: f command
  1616.  
  1617.       gcolors bgcolor, color1,... Select colors for the graphic file
  1618.         transfer display provided with ZCOMM and gYam flavors.  On PCDOS
  1619.         (and SCO Unix) flavors, operand values correspond to the video
  1620.         numeric parameters.  This command is normally generated by the
  1621.         gcolors program described in Chapter 13.
  1622.  
  1623.         EXAMPLE: gcolors 15,2,12,120,10,6,14,6,31,7,12,2,14,15,15,0,0
  1624.         selects a color scheme suitable for Aliens III.
  1625.  
  1626.  
  1627.       get filespec Instructs a remote Kermit server to the transmit the
  1628.         specified file(s), then receives them.  The form of filespec varies
  1629.         with the remote system; it must be quoted if it contains any special
  1630.         characters or spaces.  The get command only operates with a Kermit
  1631.         server; use kermit rb to receive files from a regular Kermit
  1632.         program.
  1633.  
  1634.       goback label Search the current script file for label: and execute
  1635.         commands starting at that line.  The goback command begins the
  1636.         search at the beginning of the file.  It is faster than the goto
  1637.         command which begins the search at the current line.
  1638.  
  1639.         SEE ALSO: goto command
  1640.  
  1641.       gosub name[.scriptfile] Call a script as a subroutine.  The phone
  1642.         directory is searched for name unless another file is specified with
  1643.         .scriptfile.  Gosub has the same action as the call command (q.v.),
  1644.         but does not reset term options, disconnect the modem, or modify the
  1645.         remote parameter.
  1646.  
  1647.         EXAMPLE: gosub dosig Executes the dosig entry in the telephone
  1648.         directory.
  1649.  
  1650.  
  1651.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1652.  
  1653.  
  1654.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                  119
  1656.  
  1657.         EXAMPLE: gosub .%lib/baud.t Executes the commands in c:/yam/baud.t
  1658.         assuming the lib string parameter contains c:/yam.
  1659.  
  1660.  
  1661.         SEE ALSO: call command
  1662.  
  1663.       goto label Search the current script file for label: and execute
  1664.         commands starting at that line.  A label begins at the first column
  1665.         and ends with a colon (:).  Iff label precedes the current script
  1666.         line, the goback command will locate the target label more quickly.
  1667.         The goto command is valid only within a script or telephone
  1668.         directory entry.  Please refer to Chapter 99 for examples using the
  1669.         pattern, if, goto, and source commands.
  1670.  
  1671.       grab svar Grab reads a line from the currently open transmit file into
  1672.         the specified string parameter svar.  Unless b term option is on,
  1673.         all characters starting with the first CR and/or LF are discarded.
  1674.         Grab inhibits transmission of the open file until g term option is
  1675.         explicitly set by a command.
  1676.  
  1677.         On end of file the transmit file is closed and the string parameter
  1678.         is set empty.  End of file can be tested with the t test condition.
  1679.  
  1680.         SEE ALSO: putv command
  1681.  
  1682.       HAndshake {off|sw|on|cts|dsr|dcd|both|slow|ax} Some modems and
  1683.         printers cannot accept continuous full speed data.  These devices
  1684.         send control characters (XOFF and XON) for flow control, or generate
  1685.         a hardware flow control signal on the CTS, DSR, or DCD pin.  The
  1686.         Handshake command controls the modem port hardware handshake
  1687.         (default sw).[10]
  1688.  
  1689.         If hardware handshaking is selected, an ON to OFF transition on the
  1690.         specified control pin pauses transmission, and an XON character will
  1691.         not override the hardware restraint.
  1692.  
  1693.         After a timeout set by the S numeric parameter (default 60 seconds),
  1694.         or if characters are in the keyboard input buffer, a warning message
  1695.         is displayed, the restraint is released, and characters are sent.
  1696.  
  1697.         Best for most hardware handshaking applications, handshake on obeys
  1698.         output flow control with the CTS input signal, asserts input flow
  1699.  
  1700.  
  1701.       __________
  1702.  
  1703.       10. ZCOMM automatically disables its software (XON/XOFF) flow control
  1704.           when using XMODEM, YMODEM and similar protocols that require all
  1705.           256 byte codes.  These protocols may not work if the modem is set
  1706.           for software flow control.
  1707.  
  1708.  
  1709.  
  1710.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1711.  
  1712.  
  1713.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                  120
  1715.  
  1716.         control with the RTS output signal, and disables the transmission of
  1717.         XOFF characters when the modem input buffer becomes nearly full.
  1718.  
  1719.         Some computers do not support concurrent disk and serial I/O at high
  1720.         speeds.  The handshake slow command drops the RTS signal to the
  1721.         modem during disk writes when receiving files with YMODEM-g or
  1722.         ZMODEM.  The handshake slow command does not correct overrun
  1723.         problems caused by TSRs and multitasking executives.
  1724.  
  1725.         The handshake both command allows either CTS or XOFF to pause
  1726.         output, in addition to asserting input flow control with the RTS
  1727.         output.  This is useful when the local modem uses CTS/RTS hardware
  1728.         flow control, but calls a timeshaing system or network such as
  1729.         GEnie, CompuServe, Telenet, or Tymnet that uses software (XON/XOFF)
  1730.         flow control.
  1731.  
  1732.         The handshake dcd command enables d term option (q.v.).
  1733.         Subsequently, selecting a different type of handshaking will disable
  1734.         d term option.  Use of handshake dcd is not recommended.
  1735.  
  1736.         The handshake off command disables all flow control except for XOFF
  1737.         characters sent by the term function.
  1738.  
  1739.         The handshake ax command takes the low order 5 bits of the first
  1740.         letter of the command (usually "a") and writes them to the
  1741.         8250/16550 UART Modem Control Register.  This hack is specific to
  1742.         PCDOS flavors.  A typical application is "ha ax" which raises Data
  1743.         Terminal Ready (bit 0) but turns off Request To Send, useful for
  1744.         interfacing to the Radio Shack Micronta Cat. No. 22-182 LCD Digital
  1745.         Multimeter with PC Interface.  This instrument uses an optical
  1746.         coupler and will not communicate unless DTR is ON and RTS is OFF.
  1747.  
  1748.         The handshake command (without argument) releases flow control
  1749.         (allows data to flow if it had been stopped by handshaking).
  1750.  
  1751.         Changing the communications port with the port or portx command
  1752.         disables hardware handshaking.
  1753.  
  1754.         Operation of the handshake command varies with the operating system
  1755.         and hardware used.
  1756.  
  1757.  
  1758.         SEE ALSO: S numeric parameter
  1759.  
  1760.         EXAMPLE: handshake on Turns on RTS/CTS handshaking.
  1761.  
  1762.  
  1763.       help The help command uses the helpfile or xhelpfile string parameter
  1764.         depending on whether ZCOMM is in host operation.  Normally, the help
  1765.         command displays a command summary, pausing every 24 lines.
  1766.  
  1767.  
  1768.  
  1769.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1770.  
  1771.